home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Software Vault: The Gold Collection
/
Software Vault - The Gold Collection (American Databankers) (1993).ISO
/
cdr09
/
cfr111.zip
/
CFR.HLP
< prev
next >
Wrap
Text File
|
1993-06-09
|
17KB
|
416 lines
CFR HELP INDEX Page #
============================================================
What this Program Can Do ........................ 2
Warning ......................................... 3
Introduction .................................... 4
Program Default Screen ........................... 5
Cross Reference Screen .......................... 8
What if PAF Information is Different ............. 8
Need TO Add Screen .............................. 9
LOG File ........................................ 9
CFR.DEF File .................................... 10
How Program Works ............................... 19
What If Errors Occur ............................ 21
Page 1
WHAT this PROGRAM CAN DO:
The purpose of this program is to allow a much more convenient
method to find differences and make changes for the data files created
by the Personal Ancestral File program (PAF). PAF is a copyrighted
program of The Corporation of the President of The Church of Jesus
Christ of Latter-day Saints. I will refer to this program as PAF from
this point on.
This program allows the computer to do much of the work of
comparing two different Genealogical data bases. The amount of
information compared within both data bases is determined by the
operator. The choices are; 1. Direct line, ancestors only, 2. All
lines, Ancestors & Decedents except multiple marriages. If the
individual, marriage or notes are different the differences are
Page 2
[ displayed on the screen (optional see CFR.DEF file) ] and printed in
a document file or printer.
To compare multiple marriages rerun the program using the nonancestral
spouse as the first individual.
This program does not allow the use of external note file pointed
to by the ID# Record entry. (See PAF documentation)
WARNING:
TRY NOT TO DO THIS!!! use Ctrl-Break or turn the power off
with in the program this may results in loss of your
data files. The program will not process a Ctrl-Break
until the program is at a safe point.
INSTEAD DO THIS!!! If you want to stop use Function Key 3
as provided within the program.
Page 3
I DO Not take responsibility for any data LOSS caused by the use of
this program! I have made a sincere effort to eliminate these type
of error. But the possibility of errors does exist.
INTRODUCTION:
My brother and I decided to provide our brothers and sisters with
all the genealogical information we have assembled for our family. We
became very frustrated trying to compare and combine our two data
bases and keep them up dated as well as trying to keep the rest of the
family updated with all the changes. With the current PAF software it
became necessary to reprint almost all the information and
redistribute it to the family. This program allows us to only reprint
the pages that have information that is changed and not just because
one of the RIN's or MRIN's numbers have changed.
Page 4
PROGRAM DEFAULT screen:
1. Specify SOURCE #1 drive:[path] :
Source #1 is the data file that you originally had. This option
allows you to change the drive and/or sub-directory from which the
SOURCE #1 information comes from and which. The default for this
value in the CFR.DEF file.
2. Specify SOURCE #2 drive:[path] :
Source #2 is the data file that you just received and want to check
for differences. This option allows you to change the drive and/or
sub-directory from which the information to be compared with the
SOURCE #1 data files. The default for this value in the CFR.DEF
file.
For 1 & 2: Acceptable examples are as follows. "c", "c:",
"c:\GEN", "c:\GEN\"
Page 5
3. Log File ........ <NUL>,<PRN>,<drive:[path]CFRLOG> :
This option is very useful for documenting any changes you need to
make to the SOURCE #1 data base. These differences would be any
Individual, Marriage or Notes that need to be changed or added. It
also includes RIN, MRIN and the things that are different. In the
case of notes that need to be added they need to be edited using
PAF note editor. The default for this value is in the CFR.DEF
file.
4. First Individual Source #1 & #2 ............ RIN # :
This is the RIN's numbers for the individual that the comparison
process start with. You must use PAF to manually find this
individual in both data bases and enter the RIN's here. See
Comparison method to determine how comparison goes form here.
Page 6
5. Comparison method ... :
This option allows the user to compare and SOURCE #2 all or just
one line in there ancestry. The choices are; Ancestors, All
(Ancestors and Decedents of the First Individual). The starting
person is defined by the person in the above option. Note that the
individuals spouses lines are not compared in the Direct line
option.
6. Continue:
This is the option that is used to proceed with execution of the
program
7. Quit:
No explanation necessary
Page 7
CROSS REFERENCE screen:
In some cases enough information is not available for the program
to determine if a person or marriage is the same. In these cases it
displays all the available information about the person or marriage
and a pop up screen will ask if they are the same and show you the
possibilities you have to chose form. You tell the computer they are
the same by pressing a "y" or "n".
WHAT if PAF INFORMATION is DIFFERENT:
A switch in the CFR.DEF file determines if the program displays
every difference on the screen. Aut0='N' will display each individual
and marriage that is different on the screen. Pressing any key will
continue program execution. Aut0='Y' will disable this option. In
ether case more detailed information will be written to the log file.
Page 8
NEED TO ADD screen:
In the case where an individual, marriage or note is not present
in the SOURCE #1 file a pop up question will tell you that you need to
add the person, individual or note. You tell the computer it okay to
progress by pressing any key. This will never happen if Aut0='Y' they
are automaticly added.
LOG file:
A log file has been added for convenience. This file tell of all
the difference the program found between the two files. It also
contains information about each data file. The total number of
individuals, marriages compared. It lists all the individuals,
marriages that need to be added. The order that information is
presented is the same order that it was executed.
Page 9
CFR.DEF file:
"This file is the default file for 640K machine"
MAX NAME SIZE=7709
MAX INDIVIDUAL SIZE = 32768
MAX MARRIAGE SIZE = 15000
NUMBER OF NOTE LINES = 100
NUMBER OF HELP LINES = 402
PATH1$=C:\GEN\DATA\
PATH2$=C:\GEN\TEMP\
AUT0 = Y
LOG FILE=C:\GEN\MYPROG\COMPARE.LOG
PRINT FAMILY TO DOC=N
DISPLAY FREE MEMORY=Y
STACK HISTORY=N
LINES TO COMPARE=Ancestors
SOURCE#1 FIRST RIN #=1
Page 10
SOURCE#2 FIRST RIN #=1
BACKGROUND = Blue
BORDER = Cyan
TEXT = White
TITLES = Magenta
ERROR=Red
CHOICE = Black
Page 11
MAX NAME SIZE:
Is the maximum number of names that can be in the SOURCE #1 in the
NAME2.DAT file plus new names added form SOURCE #2. The value of
this will very with computer configuration. But must be less than
7709 (uses 17 Bytes/name).
MAX INDIVIDUAL SIZE:
The maximum number of individuals that can be in the SOURCE #1 in
the INDIV2.DAT files. The value of this will very with computer
configuration. But must be less than 32,767.
MAX MARRIAGE SIZE:
The maximum number of marriages that can be in the SOURCE #1 in the
MARR2.DAT files. The value of this will very with computer
configuration. But must be less than 32,767.
Page 12
NUMBER OF NOTE LINES:
This the maximum number of lines that can be displayed for any
individuals note. Decreasing this will free up memory for other
things.
NUMBER OF HELP LINES:
This the maximum number of lines that can be displayed when F1 is
pressed. Decreasing the number of help lines to 1 will free up the
memory used by this file thus freing memory for other things.
PATH1$:
Specify SOURCE #1 drive:[path] :
Source #1 is the data file that you originally had. This option
allows you to change the drive and/or sub-directory from which the
SOURCE #1 information comes from and which. The default for this
value in the CFR.DEF file.
Page 13
PATH2$:
Specify SOURCE #2 drive:[path] :
Source #2 is the data file that you just received and want to check
for differences. This option allows you to change the drive and/or
sub-directory from which the information to be compared with the
SOURCE #1 data files. The default for this value in the CFR.DEF
file.
AUT0:
Y = Differences are not displayed on the screen
N = Differences are displayed on the screen
LOG FILE:
<NUL>,<PRN>,<drive:[path]CFRLOG> :
This option is very useful for documenting any changes you need to
make to the SOURCE #1 data base. These differences would be
Page 14
any Individual, Marriage or Notes that need to be changed or added.
It also includes RIN, MRIN and the things that are different. In
the case of notes that need to be added they need to be edited
using PAF note editor. The default for this value is in the
CFR.DEF file.
PRINT FAMILY TO DOC:
Used for debugging the program. Prints all the members of each
family into the Log file.
DISPLAY FREE MEMORY:
Top left hand corner will show number of bytes left for entries
from NAME2.DAT then the rest of space for all other arrays. Also
in the top right hand corner the average length of all name entries
will be displayed. "Y" or "N" or "y" or "n"
Page 15
STACK HISTORY:
Used for debugging the program. Prints all marriages as they are
pushed and poped form the stack into the 'stack.his' file.
LINES TO COMPARE:
Ancestors(Direct line only):
This option allows the user to compare and SOURCE #2 all or just
one line in there ancestry. The starting person is defined by the
person in the above option. Note that the and spouse of the first
Individual and spouses of children are not compared in the Direct
line option. !!! Ancestors only works in this Version.!!!
SOURCE#x FIRST RIN #S:
This is the RIN # for the SOURCE #1 and SOURCE #2 Individual that
the comparison process start with. In the Direct line only mode
comparison goes back from this individual. Where as in the All
Lines mode comparison goes up and down all lines from here.
Page 16
BACKGROUND: Color of the background. See following chart.
BORDER: Color of the screen border. See following chart.
TEXT: Color of the Text. See following chart.
TITLES: Color of the Title. See following chart.
ERROR: Color of the Error message. See following chart.
CHOICE: Color of the prompt requiring a response. See chart.
Page 17
Valid Colors
================================
Black, Gray
Blue, Bright Blue
Green, Bright Green
Cyan, Bright Cyan
Red, Bright Red
Magenta, Bright Magenta
Brown, Yellow
White, Bright White
Page 18
HOW the PROGRAM WORKS:
Direct line only method is as follows. A individual is chosen
his parents marriage is compared and all of the siblings are
compared at this time also. The parents are then placed in the
position of the first individual and the cycle is repeated again.
Progression goes from Child to Father up the paternal line until
the end of the line is reached. Then it steps back to mother and
up her paternal line and so forth. Children's spouses and their
lines are not compared.
All lines is similar to direct line only except the lines of
the children's spouses are also put in to the compare sequence.
Page 19
The maximum number of Names is defined by MAX NAME SIZE in
CFR.DEF. Note program will stop if string memory is used up. The
maximum number of Individuals is MAX SIZE in CFR.DEF. The maximum
number of Marriages is MAX SIZE/2 in CFR.DEF.
It should also be noted that the base RIN is assumed to be 0.
This is also the case with the base MRIN is assumed to be 0 as well
as the Volume number is also 0.
Note that if a birthday is not present the Christening Date
then the Death date and finally the Burial date is used for cross
referencing.
The program doesn't differentiate between names that are upper
case and those and those that are lower case.
Page 20
WHAT IF ERRORS OCCUR:
Out of memory errors as you start the program:
If you start the program and get an out of memory error try the
following; 1. Reduce the size of 'MAX NAME SIZE', 'MAX INDIVIDUAL
SIZE' 'MAX MARRIAGE SIZE' they still must fit requirements defined
above. 2. Reduce the 'NUMBER OF NOTE LINES' this may make the
program crash if you have a note for an individual more than the
number you defined. 3. Disable th help function by reducing
'NUMBER OF HELP LINES' this make the program crash if you press F1.
Start with step 1 and progress until the program will run.
File not found error or invalid path statement:
This will occur if you have defined the 'PATH1$' or 'PATH2$'
incorrectly. It could also happen if the CFR.DEF is not in the
Page 21
default directory. Ether change the default directory or execute the
program as "CFR d:\correct path\CFR.DEF". Note this allows you to
have several default file and you can choose which you can run
with.
I would be interested if anyone finds errors in this program.
Please send me a copy of the log file, and the two sets of PAF data
files and the 'STACK.HIS'. Then I possibly can recreate the error and
correct it.
Ernest Esplin
131 Briarwood
Versailles Ky. 40383
Page 22